Projekt unter Git-Kontrolle bringen

Voraussetzung: CODESYS Git ist installiert. Sie haben ein CODESYS-Projekt geöffnet.

1. Bereiten Sie im Dateisystem ein leeres Verzeichnis für die Git-Projektablage vor, das das lokale Git-Repository enthalten soll. Beispiel: D:\git_local\rep1

2. Öffnen Sie das CODESYS-Projekt, das unter Git-Verwaltung gebracht werden soll, in CODESYS Git. Beispiel: myproj.project.

3. Wählen Sie den Befehl Git → Git-Repository initialisieren....

   Der Dialog Git-Repository initialisieren öffnet sich.

4. Tragen Sie im Dialog den Pfad des leeren Verzeichnisses für die Git-Projektablage ein (Beispiel: D:\git_local\rep1). Das darin angelegte Git-Repository wird Ihr lokaler „master“.

   1. Falls im lokalen Benutzerverzeichnis (z.B. C:\Benutzer\m.muster) noch keine globale Konfigurationsdatei .gitconfig vorliegt, werden Sie jetzt in einem Meldungsdialog aufgefordert, eine solche Grundkonfiguration für alle CODESYS Git-Aktionen anzulegen. Sie erhalten zur Eingabe einiger Parameter denselben Dialog wie über den Befehl Git Config. Die Standardeinstellung für Standard-Branch ist master. Geben Sie Ihre Benutzerdaten Benutzername und Email-Adresse an (Beispiel m.muster, m.muster@company.com).

   2. Die Objekte im Projektnavigator sind mit blauen Plussymbolen (Status „hinzugefügt“) versehen, der Wurzelknoten (Projektname) mit einem orangem Quadratsymbol (Status „geändert“).

   3. In der Ansicht Git → Projekteinstellungen wird der Pfad der Git-Projektablage angezeigt.

   4. Damit ist die Projektverwaltung in dem in der Projektablage liegenden Git-Repository initialisiert.

5. Speichern Sie das Projekt, wie ohne Git-Verwaltung üblich, in einem separaten Projektverzeichnis (Beispiel: D:\git_projects\myproj.project). Hinweis: Die Projektdateien unterliegen somit doppelter Datenhaltung.

6. Öffnen Sie die Ansicht Git-Status. Wählen Sie die im unteren Teil Nicht vorgemerkte Änderungen die angezeigten Projektobjekte aus. Klicken Sie dann auf die Schaltfläche , um sie für einen Commit vorzumerken.

   Die Objekte werden nach oben unter Vorgemerkte Änderungen verschoben.

7. Klicken Sie die Schaltfläche (Commit). Geben Sie im Dialog Vorgemerkte Änderungen committen eine Commit-Meldung ein und bestätigen Sie mit OK.

   Der aktuelle Stand der Projektobjekte wird in das lokale Repository übertragen.

8. Wählen Sie den Befehl Git → Git History.

   1. In der Ansicht History wird der erste Commit für den „master“ mit Informationen dazu dargestellt.

   2. Im Projektnavigator erscheinen grüne Kreissymbole vor den committeten Objekten und auch vor der Wurzel. Dies bedeutet, der Stand des Projekts ist synchron mit seinem Stand im Git-Repository.

9. Wählen Sie den Befehl Git → Git Branches und aktivieren Sie den Filter Local (1).

   Der Default-Branch für das Git-Repository ist als master (refs/heads/master) sichtbar.

10. Sehen Sie im Dateisystem ins lokale Repository D:\git_local\rep1.

    Hier liegt jetzt das Verzeichnis .git (das eigentliche Git-Repository) mit dem Unterverzeichnis project und den Dateien .gitattributes, .gitignore und .apsession. Das Verzeichnis project enthält die Objekte des CODESYS-Projekts.

11. Nun können Sie das Projekt, sobald erforderlich, noch mit einem Remote-Repository verbinden.

Voraussetzung: CODESYS Git ist installiert. Sie haben Zugriff auf ein Remote-Repository.

1. Öffnen Sie CODESYS Git. Wählen Sie den Befehl Git → Git-Repository klonen.... Er ist verfügbar, wenn kein CODESYS-Projekt geöffnet ist.

   Der Dialog Git Clone öffnet sich.

2. Geben Sie als Quell-URL die URL oder den Dateipfad des zu klonenden Remote-Repositorys an (Beispiel: D:\git_remotes\remote1).

   Geben Sie bei Git-Speicherpfad das für die neue Git-Projektablage (neues Git-Repository) vorgesehene leere Dateiverzeichnis an (Beispiel: D:\git_local\rep1).

   Geben Sie bei Projektdatei ein Projektverzeichnis an, in dem das neue CODESYS-Projekt zusätzlich und außerhalb von Git (!) abgelegt werden soll (Beispiel: D:\git_projects\myproj1.project, doppelte Datenhaltung!).

   Wählen Sie bei Projektdateityp, ob es ein Standardprojekt oder ein Bibliotheksprojekt werden soll. Bestätigen Sie den Dialog.

   Falls im lokalen Benutzerverzeichnis (z.B. C:\Benutzer\m.muster) noch keine globale Konfigurationsdatei .gitconfig vorliegt, werden Sie jetzt in einem Meldungsdialog aufgefordert, eine solche Grundkonfiguration für alle CODESYS Git-Aktionen anzulegen. Sehen Sie dazu oben die Anleitung für das Initialisieren eines Git-Projekts, Schritt 4.

   Wenn die Git-Option Selbstsigniertes Zertifikat akzeptieren nicht aktiviert ist, prüft CODESYS Git zunächst das Zertifikat für die Verbindung mit dem Server, von dem das Projekt geklont werden soll. Wenn das Zertifikat nicht vertrauenswürdig ist, erhalten Sie die Möglichkeit, die Verbindung nach persönlicher Prüfung dennoch zuzulassen.

   Das neue Projekt wird geöffnet. Das neue Arbeitsverzeichnis wird angelegt und automatisch als Git-Repository initialisiert. Es enthält zunächst genau den Stand des Remote-Repositorys zum Zeitpunkt des Klonens.

3. Wählen Sie im CODESYS-Projekt den Befehl Git → Git Branches.

   In der Ansicht Git-Branches sind bereits die Remote-Branches zu sehen. Standardmäßig wird für den Remote-Branch „master“ auch ein lokaler Branch „master“ angelegt, der den Remote-Branch trackt. Sie können nun sofort auf diesem lokalen Branch arbeiten. Auch eine Verbindung (Tracking) des lokalen Branches zum „Stellvertreter“-Remote-Branch (origin/master) des neuen Git-Repositorys ist bereits hergestellt.

1. Wählen Sie den Befehl Git → Git-Remotes. Klicken Sie in der Ansicht Git-Remotes auf die Schaltfläche Hinzufügen.

   Der Dialog Neues Git-Remote hinzufügen öffnet sich.

2. Geben Sie den Pfad und einen Namen für das anzubindende Remote-Repository ein. Beispiel: Alias-Name: origin, URL: D:\git_remote.

3. Führen Sie den Befehl Fetch aus und wechseln Sie dann mit dem Befehl Git → Git-Branches zur Ansicht Git-Branches.

   Üblicherweise sind für den Zugriff auf ein Remote-Repository Anmeldedaten nötig. Nur falls auf dem Computer keine gültigen Anmeldedaten gefunden werden, erhalten Sie zur Eingabe den Dialog Anmeldedaten erforderlich. Sehen Sie für weitere Informationen: Anmeldedaten erforderlich.

4. Aktivieren Sie den Filter Remote (<n>).

   Sie sehen die Remote-Branches.

5. Deaktivieren Sie den Filter Remote (<n>). Aktiveren Sie den Filter Lokal (1). Selektieren Sie den Eintrag master und wählen Sie den Befehl Upstream Set. Wenn es für das gewählte Remote-Repository noch keinen Remote-Branch (origin/master) gibt, geschieht Folgendes:

   Der Dialog Upstream-Remote für Branch setzen öffnet sich. Der Remote-Name origin ist bereits vorgegeben.

6. Bestätigen Sie die Eingaben mit OK.

   → Für den master sind die Optionen Tracking und Aktueller aktiviert. Unter Tracked Branch, Name steht origin/master.

   Das bedeutet, der Remote-Branch origin/master für das Remote-Repository ist intern angelegt. Er dient nur als Stellvertreter, auf diesem Branch wird nicht direkt gearbeitet.

7. Selektieren Sie den master und klicken Sie Push, um. Aktivieren Sie den Filter Remote (1).

   Nun wird der Stellvertreter-Branch origin/master unter Git-Branches Remote (1) auch angezeigt. Die Verbindung vom lokalen master zum Remote-Repository über dessen Stellvertreter origin/master ist hergestellt.

8. Nun können Sie in der Ansicht Git-Branches Lokal (<1>) den lokalen Branch (master) des Git-Repositorys mit Hilfe des Befehls Branch tracken mit dem neuen Remote-Branch des Remote-Repositorys verknüpfen.